/*
 * RMFacadeMonitorMBean.java    ver   27/nov/2009
 *
 * Copyright (c) 2009 mentalsmash.org
 * 
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 * http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 *
 * The use of the Apache License does not indicate that this project is
 * affiliated with the Apache Software Foundation.
 */
package org.mentalsmash.tazio.transactions.management.rm;

import org.mentalsmash.tazio.transactions.management.StatusResponse;

/**
 * Monitors the facade exposted by a single Replica Manager, that is the only
 * point of access to RM services for externa WRMs
 * 
 * @version ver 27/nov/2009
 * @author Andrea Reale <andrea.reale@gmail.com>
 * 
 */
public interface RMFacadeMonitorMBean {

    /**
     * Returns the number of commit requests from any WRM to this instance of
     * Replica Manager
     * 
     * @return the number of commit requests from any WRM to this instance of
     *         Replica Manager
     */
    int getNumCommitRequests();

    /**
     * Returns the number of WhatAboutThisTransaction requests from any WRM to
     * this instance of Replica Manager
     * 
     * @return the number of WATT requests from any WRM to this instance of
     *         Replica Manager
     */
    int getNumWATTRequests();

    /**
     * Returns the number of BEGIN requests from any WRM to this instance of
     * Replica Manager
     * 
     * @return the number of BEGIN requests from any WRM to this instance of
     *         Replica Manager
     */
    int getNumBeginRequests();

    /**
     * Returns the number of RootSet requests form any WRM to this instance of
     * RM
     * 
     * @return the number of RootSet requests form any WRM to this instance of
     *         RM
     */
    int getNumGetRootSetRequests();

    /**
     * Return the number of responses to WATT requests, that were
     * {@link StatusResponse#UNKNOWN}.
     * 
     * @return the number of responses to WATT requests, that were
     *         {@link StatusResponse#UNKNOWN}.
     */
    int getNumUnknownWattResponses();

    /**
     * Returns the average duration in milliseconds of a commit request from a
     * WRM
     * 
     * @return the average duration in milliseconds of a commit request from a
     *         WRM
     */
    double getAvgCommitRequestDuration();
    
    /**
     * Returns the maximum duration in milliseconds of a commit request from a
     * WRM
     * 
     * @return the maximum duration in milliseconds of a commit request from a
     *         WRM
     */
    long getMaxCommitRequestDuration();
    
    /**
     * Returns the minimum duration in milliseconds of a commit request from a
     * WRM
     * 
     * @return the minimum duration in milliseconds of a commit request from a
     *         WRM
     */
    long getMinCommitRequestDuration();
    
    double getStdDeviationCommitRequest();

}
